home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Object Oriented Applicat…isualAge for C++ for OS/2
/
Object-Oriented Application Development with VisualAGE for C++ for OS2.iso
/
visual
/
epfihplb.hlp
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1995-11-20
|
87KB
|
3,668 lines
ΓòÉΓòÉΓòÉ 1. Installation and Maintenance Utility ΓòÉΓòÉΓòÉ
Use the Installation and Maintenance Utility window to install, update,
restore, or delete a product.
Select Open catalog from the File pull-down to obtain a list of products you
can work with on a particular system. After you have obtained a list, select a
product from the list, and you can do one of the following:
o Install
o Update
o Restore
o Delete
ΓòÉΓòÉΓòÉ 1.1. File ΓòÉΓòÉΓòÉ
Select the File menu to:
o Open or refresh a product list
o Exit the installation and maintenance utility
ΓòÉΓòÉΓòÉ 1.1.1. Open catalog ΓòÉΓòÉΓòÉ
Select Open catalog from the File menu to open a catalog of installable
products. You must open a product list before you can install or update a
product.
When you select Open catalog you are given a choice of opening a catalog from a
host operating system or from a drive.
ΓòÉΓòÉΓòÉ 1.1.2. Open host catalog ΓòÉΓòÉΓòÉ
Select Host to open a product list from an MVS, VM or VSE system.
When you select Host, a window prompts you for:
o A host session
o The host operating system that you want to query the catalog from
o The name of the catalog file that you want to download from the host
ΓòÉΓòÉΓòÉ 1.1.3. Open drive catalog ΓòÉΓòÉΓòÉ
Select Drive to open a catalog of installable products from a diskette drive, a
CD ROM drive, a LAN drive, or an AS/400 PC support folder.
When you select Drive, a window prompts you for:
o The drive you want to install a product from
o The directory and file name of the catalog that you want to open
ΓòÉΓòÉΓòÉ 1.1.4. Exit ΓòÉΓòÉΓòÉ
Select Exit from the File menu to exit the installation and maintenance
utility.
ΓòÉΓòÉΓòÉ 1.2. Details ΓòÉΓòÉΓòÉ
Select the Details menu to see:
o A description of the selected product
o The status and service level of the selected product on the workstation
o The disk space required to install the selected product.
ΓòÉΓòÉΓòÉ 1.2.1. Product description ΓòÉΓòÉΓòÉ
Select Product description from the Details menu to see general information
about the selected product.
Selecting this choice queries the source for a product description and displays
the description in a window.
ΓòÉΓòÉΓòÉ 1.2.2. Product status ΓòÉΓòÉΓòÉ
Select Product status from the Details menu to see the following information
about the selected product:
o Product name
o Product number
o Version, release, and modification currently installed on the workstation
o Feature currently installed on the workstation
o Components, if any, installed on the workstation
o Service levels installed on the workstation
o Drive and directories that the product is installed in
The product status choice can be selected only if the selected product is
installed.
ΓòÉΓòÉΓòÉ 1.2.3. Disk space ΓòÉΓòÉΓòÉ
Select Disk space from the Details menu to see:
o Amount of space required to install the selected product
o Total amount of disk space available on your workstation drives
o If installation is possible on a selected workstation drive
Note: If you are planning to update a product, the product may require less
disk space than indicated because some files may overwrite existing
versions.
ΓòÉΓòÉΓòÉ 1.3. Action ΓòÉΓòÉΓòÉ
Select the Action menu to:
o Install the selected product
o Update the selected product to a new service level
o Restore a previously saved service level of the selected product
o Delete the selected product from the workstation
ΓòÉΓòÉΓòÉ 1.3.1. Install ΓòÉΓòÉΓòÉ
Select Install from the Action menu to install the selected product.
When you select Install, the following occurs:
1. A confirmation window displays information about the product you selected
to install.
2. Another window is displayed requesting the names of the directories you
want to install the product in and the components you want to install (if
the product contains components).
3. A progress window is displayed and the product is installed in the
specified directories.
4. The Update and Delete pull-down choices for the selected product are made
available.
The Install choice is available if any components of the selected product are
not yet installed.
ΓòÉΓòÉΓòÉ 1.3.2. Update ΓòÉΓòÉΓòÉ
Select Update from the Action menu to update an installed product to a more
recent service level.
When you select Update:
1. A confirmation window displays information about the product you selected
to update.
2. A progress window is displayed and the product is updated in the
directories that you specified during the initial installation.
3. The Restore pull-down choice becomes available for the updated product if
a backup was saved.
The Update choice is available only for products that have been installed or
that have at least one component installed.
ΓòÉΓòÉΓòÉ 1.3.3. Restore ΓòÉΓòÉΓòÉ
Select Restore from the Action menu to restore the selected product to the
previous service level.
When you select Restore:
1. A confirmation window displays information about the product you selected
to restore.
2. A progress window appears and files from the previous service level
replace the files in the currently installed service level.
3. The Restore pull-down choice for the selected product is made
unavailable.
The Restore choice is only available if the selected product has been
installed and updated with the Save a backup version option selected.
ΓòÉΓòÉΓòÉ 1.3.4. Delete ΓòÉΓòÉΓòÉ
Select Delete from the Action menu to delete the selected product from the
workstation. If the product contains components, specific components can be
selected for deletion.
This action also allows any backup versions to be deleted without deleting the
current version.
When you select Delete:
1. A confirmation window displays information about the product you selected
to delete. If the product contains components, the components that you
want to delete can be selected.
2. A progress window appears and all files that are associated with the
selected product (or components of the product) are deleted. If you
select the Delete only the backup versions check box, only the backup
version of the product is deleted.
3. The Update, Delete, and Restore pull-down choices for the selected
product are made unavailable if the entire product has been deleted.
4. The Install pull-down choice for the selected product is made available.
The Delete choice is available when any component of the selected product is
installed.
ΓòÉΓòÉΓòÉ 1.4. View ΓòÉΓòÉΓòÉ
Select the View menu to change the list of products displayed in the main
window list. You can:
o Display a list of all the products that are in the catalog that is
currently open
o Display a list of products that have at least one component installed
o Display a list of only the installed products that have been updated
o Display the product list in the order that it appears in the catalog file
o Sort the product list in ascending alphabetical order (A to Z)
o Sort the product list in descending alphabetical order (Z to A)
ΓòÉΓòÉΓòÉ 1.4.1. Current catalog ΓòÉΓòÉΓòÉ
Select Current catalog from the View menu to look at all the products that are
in the catalog that is currently opened. Products in this catalog that are
already installed or updated are displayed in this list. Products that are
installed or updated that are not in the current catalog are not displayed in
this list.
ΓòÉΓòÉΓòÉ 1.4.2. Installed products ΓòÉΓòÉΓòÉ
Select Installed products from the View menu to look at the products that have
at least one component installed. All installed products are displayed in this
list regardless of which source or operating system they were installed from.
Once installed, a product appears in the Installed products view even if the
product is no longer listed in the currently opened catalog. This allows it to
be deleted or restored (if a backup was saved on Update).
ΓòÉΓòÉΓòÉ 1.4.3. Updated products ΓòÉΓòÉΓòÉ
Select Updated products from the View menu to look at only the products that
have at least one component installed and updated. All installed products that
have been updated are displayed in this list, regardless of which source or
operating system they were installed from.
ΓòÉΓòÉΓòÉ 1.4.4. Catalog order ΓòÉΓòÉΓòÉ
Select Catalog order from the View menu to display the products in the product
list in the same order that they appear in the catalog file.
If the list is in the Installed products or Updated products view, then
products not in the currently open catalog will be displayed first in the list
followed by the products that are in the catalog in the order that they occur.
ΓòÉΓòÉΓòÉ 1.4.5. Ascending order ΓòÉΓòÉΓòÉ
Select Ascending order from the View menu to display the product list in
ascending alphabetical order (A to Z).
ΓòÉΓòÉΓòÉ 1.4.6. Descending order ΓòÉΓòÉΓòÉ
Select Descending order from the View menu to display the product list in
descending alphabetical order (Z to A).
ΓòÉΓòÉΓòÉ 1.5. Help ΓòÉΓòÉΓòÉ
Select this action to get to the following help:
Help for help
Gets help on using the online help facility
General help
Gets help on application windows
Keys help
Gets help on valid keys
Help index
Displays an index of help topics
ΓòÉΓòÉΓòÉ 1.5.1. Using help ΓòÉΓòÉΓòÉ
Select this pull-down choice to see a description of the types of help provided
for this application and to learn how to get help.
ΓòÉΓòÉΓòÉ 1.5.2. General help ΓòÉΓòÉΓòÉ
Select this pull-down choice to get an overview of the current window.
ΓòÉΓòÉΓòÉ 1.5.3. Keys help ΓòÉΓòÉΓòÉ
Select this pull-down choice to get help for the key definitions.
ΓòÉΓòÉΓòÉ 1.5.4. Help index ΓòÉΓòÉΓòÉ
Select this pull-down choice to use the help index. You can use the index in
two ways:
o To select a topic from a list of all help topics
o To search for a topic by selecting Search from the Services menu
ΓòÉΓòÉΓòÉ 1.5.5. Keys help ΓòÉΓòÉΓòÉ
Select this pull-down choice to get help for the key definitions.
Select a topic to get keys help on:
o Help keys
o System keys
o Window keys
o Editing keys
o Application keys
ΓòÉΓòÉΓòÉ 1.5.6. Help keys ΓòÉΓòÉΓòÉ
These are the help window key definitions:
F1
Gets help
F2
Gets general help (from within any help window)
F9
Goes to a list of keys (from within any help window)
F11 or Shift+F1
Goes to the help index (from within any help window)
Esc
Displays the previous window
Shift+F10
Gets using help
Alt+F6
Switches from help to the application window and back
Alt+F4
Exits help
ΓòÉΓòÉΓòÉ 1.5.7. System keys ΓòÉΓòÉΓòÉ
These are the system key definitions:
F1
Gets help
F3
Closes a program window
F10
Goes to or from the menu bar
Arrow keys
Move among the choices on the menu bar and pull-down menus
End
Goes to the last choice in a pull-down menu
Esc
Cancels a pull-down menu or the system menu
Home
Goes to the first choice in a pull-down menu
PgUp
Scrolls the contents of the window up one screen
PgDn
Scrolls the contents of the window down one screen
Underlined letter (mnemonic)
Calls the associated action
Alt
Goes to or from the menu bar
Alt+Esc
Switches to the next program, including full-screen programs
Alt+Tab
Switches to the next program that runs in a window
Alt+F4
Closes the window
Alt+F5
Restores the window
Alt+F6
Changes the active window in an application
Alt+F7
Moves the window
Alt+F8
Sizes the window
Alt+F9
Minimizes the window
Alt+F10
Maximizes the window
Ctrl+Esc
Switches to the task list
Ctrl+F6
Changes the active secondary window in an application
Shift+Esc or Alt+Spacebar
Goes to or from the system menu
Shift+Esc or Alt
Goes to or from the system menu of a text window
ΓòÉΓòÉΓòÉ 1.5.8. Window keys ΓòÉΓòÉΓòÉ
These are the window key definitions:
Enter
Completes the action in the window
Esc
Cancels the window
Spacebar
Sets a check box on or off or performs the task associated with the selected
push button
Tab
Moves to the next entry field, selection field, or hypertext phrase
ΓòÉΓòÉΓòÉ 1.5.9. Editing keys ΓòÉΓòÉΓòÉ
These are the editing key definitions:
Backspace (left arrow delete)
Deletes the character to the left of the cursor
Del or Delete
Deletes the character to the right of the cursor
End or Ctrl+Right arrow key
Moves to the end of a field
Home or Ctrl+Left arrow key
Moves to the beginning of a field
Ctrl+Ins
Copies the selected text to the clipboard
Shift+Print Screen
Prints the information currently displayed
ΓòÉΓòÉΓòÉ 1.5.10. Application keys ΓòÉΓòÉΓòÉ
These are the application keys definition:
F1
Gets help
F3
Ends the installation
Ctrl+D
Displays a description of the selected product
Ctrl+H
Opens a product catalog from a host
Ctrl+I
Installs the selected product
Ctrl+K
Displays the disk space required by the selected product
Ctrl+O
Opens a product catalog from a drive
Ctrl+R
Restores a previous service level of the selected product
Ctrl+S
Displays the workstation status of the selected product
Ctrl+U
Updates the selected product
Delete
Deletes the selected product
ΓòÉΓòÉΓòÉ 1.5.11. Text selection keys ΓòÉΓòÉΓòÉ
These are the text selection key definitions:
Shift+arrow
Selects text or extends a selection in the direction of the arrow
Shift+Home
Selects text or extends a selection to the beginning of the current line
Shift+End
Selects text or extends a selection to the end of the current line
Shift+Ctrl+Right
Selects text or extends a selection to the beginning of the next word
Shift+Ctrl+Left
Selects text or extends a selection to the beginning of the previous word
ΓòÉΓòÉΓòÉ 1.6. Help ΓòÉΓòÉΓòÉ
Select this push button to display the help information about the field the
cursor is in.
ΓòÉΓòÉΓòÉ 2. Cancel ΓòÉΓòÉΓòÉ
Select this push button to exit the window without committing any changes.
If the operation is in progress and you select Cancel, the operation
immediately stops and the window closes.
ΓòÉΓòÉΓòÉ 3. Open host catalog ΓòÉΓòÉΓòÉ
Use the Open host catalog window to query a list of available products from an
MVS, VM or VSE system.
To open a product list:
1. Select the ID of the host session you want to communicate with in the
Host session list box.
2. Select the Host operating system radio button that corresponds to the
operating system that is running on the host.
3. Type the name of the catalog file to be opened in the Filename
combination box. If the catalog file you want to open has been
previously opened, you can select it from the combination box drop-down
list.
4. Select the Open push button to begin the open process. The catalog file
is queried from the host. If the open is successful, this window goes
away and the opened product list is displayed in the main window.
ΓòÉΓòÉΓòÉ 3.1. Host session ΓòÉΓòÉΓòÉ
Use the Host session list in the Open host catalog window to select the
Communications Manager host session identifier that you want to use for
downloading (for example, A, B, or C). The first item in the list box is the
default.
ΓòÉΓòÉΓòÉ 3.2. Host operating system ΓòÉΓòÉΓòÉ
Select the MVS, VM, or VSE radio button in the Open host catalog window that
corresponds to the operating system that is running on the host system you
specified in the Host session list box. MVS is the default.
ΓòÉΓòÉΓòÉ 3.3. Catalog filename ΓòÉΓòÉΓòÉ
Use the Filename field to enter a catalog file name or select the catalog file
name from the drop-down list of the catalog that you want to open. Only
previously opened catalog files appear in the drop-down list.
When a catalog file name is selected from the drop-down list, the static field
above the combination box is updated to display a brief description of the
catalog file.
The catalog file name entered in this field must be a valid MVS, VM, or VSE
filename, depending on which host operating system radio button is selected.
o Sample MVS catalog file names:
PROJ.GROUP.TYPE(CATALOG)
EPF.V1R2M0.SEPFBENU(EPFICAT)
o Sample VM catalog file names:
CATALOG ICF A
EPFICAT ENUEPF12 *
o Sample VSE catalog file names:
LIBRARY.SUBLIBRARY.MEMBER NAME.MEMBER TYPE
EPF.VIR2M0.SEPFBENU.CATALOG
ΓòÉΓòÉΓòÉ 3.4. Description ΓòÉΓòÉΓòÉ
Select the Description push button in the Open host catalog window to display a
brief description of the catalog file that currently appears in the Filename
field. The description is queried from the host session you selected in the
Host session list box.
ΓòÉΓòÉΓòÉ 3.5. Open ΓòÉΓòÉΓòÉ
Select the Open push button in the Open host catalog window to open the product
catalog from the Host session you specified. Ensure that:
1. You are logged onto the host session selected in the Host session list
box and that the host session is ready to accept input.
2. The Host operating system radio button corresponds to the operating
system that is running on the host session you specified.
After you select this push button, the catalog file is downloaded from the
host session you specified, the catalog file is parsed, and the product list
is built and displayed.
ΓòÉΓòÉΓòÉ 4. Open drive catalog ΓòÉΓòÉΓòÉ
Use the Open drive catalog window to query a list of available products from a
diskette drive, a CD ROM drive, a LAN drive, or an AS/400 PC support folder.
To open a product list:
1. Select the drive that contains the catalog file you want to open from the
Drive combination box. The Filename combination box is updated with a
list of all previously opened catalog files that exist on the drive.
2. Type the name of the catalog file to be opened in the Filename
combination box. If the catalog file you want to open has been
previously opened and still exists, you can select it from the
combination box drop-down list.
3. Select the Open push button to begin the open process. The catalog file
is queried from the drive. If the open is successful, this window goes
away and the opened product list is displayed in the main window.
ΓòÉΓòÉΓòÉ 4.1. Drive ΓòÉΓòÉΓòÉ
Select the drive that contains the catalog file.
The combination box displays all drives that are connected to the workstation.
ΓòÉΓòÉΓòÉ 4.2. Catalog filename ΓòÉΓòÉΓòÉ
Type a catalog file name in the Filename field or select the catalog file name
from the drop-down list of the catalog that you want to open. Only previously
opened catalog files that still exist on the selected drive appear in the
drop-down list.
When you select a catalog file name from the drop-down list, the static field
above the combination box is updated to display a brief description of the
catalog file, if one exists.
The catalog file name you enter in this field must be a valid OS/2* file name
without a drive specification.
Sample catalog file names:
\packages\epficat.icf
\catalog.icf
ΓòÉΓòÉΓòÉ 4.3. Description ΓòÉΓòÉΓòÉ
Select the Description push button in the Open drive catalog window to display
a brief description of the catalog file that currently appears in the Filename
field. The description is queried from the drive selected in the Drive list
box.
ΓòÉΓòÉΓòÉ 4.4. Search ΓòÉΓòÉΓòÉ
Select the Search push button in the Open drive catalog window to search the
selected drive for a list of catalog files.
ΓòÉΓòÉΓòÉ 4.5. Open ΓòÉΓòÉΓòÉ
Select the Open push button in the Open drive catalog window to open the
product catalog from the Drive you specified.
After you select this push button, the catalog file is read from the selected
drive and processed. Then the product list is built and displayed.
ΓòÉΓòÉΓòÉ 5. Product status ΓòÉΓòÉΓòÉ
Use the Product status window to see information about a product that is
currently installed on the workstation. The following information is
displayed:
Product name
The name of the selected product that is currently installed on the
workstation
Product number
The official product number assigned to the selected product
Version
The version, release, and modification number of the selected product
Feature
The feature number of the selected product
Directories installed in
The directories where the product is installed
The service level of the product can be determined by selecting the Service
level push button. The Service level window is then displayed.
ΓòÉΓòÉΓòÉ 5.1. Cancel ΓòÉΓòÉΓòÉ
Select the Cancel push button in the Product status window to close the window
and return to the main window.
ΓòÉΓòÉΓòÉ 6. Disk space ΓòÉΓòÉΓòÉ
Use the Disk space window to check the disk space needed to install the
selected product.
This window also allows you to check the amount of space available on any of
the workstation hard disks, and it reports whether installation is possible on
the specified drive.
To see whether you can install a product on a hard disk:
1. Select the hard disk in the Drive list box
2. Read the message next to the Drive list box to determine if you have
enough available space to install the product on the selected hard disk
Note: Updating the product may require less disk space than indicated if the
installation and maintenance utility overwrites some existing files
during the update. So, even though the window may show there is not
enough workstation disk space to install the selected product, you can
still attempt to update the product.
The fields in the Disk space window are:
Product name
The name of the selected product
Bytes needed
The amount of space needed to install the selected product
Bytes available
The amount of space available on the workstation drive specified
Installation possible
A message indicating that you can install the selected product on the drive
specified
Installation not possible
A message indicating that you cannot install the selected product on the
drive specified
ΓòÉΓòÉΓòÉ 6.1. Available space ΓòÉΓòÉΓòÉ
Use the Available space list box in the Disk space window to look at the amount
of unused space on each workstation hard disk. Use this list to determine which
drive you want to install the product on.
When you select a drive, the status message next to the list box is updated.
This message indicates whether there is enough disk space available on the
selected drive to allow you to install the product.
ΓòÉΓòÉΓòÉ 6.2. Cancel ΓòÉΓòÉΓòÉ
Select the Cancel push button in the Disk space window to close the Disk space
window.
ΓòÉΓòÉΓòÉ 6.3. Change directories ΓòÉΓòÉΓòÉ
Select this check box to change all drive letters for the directories on the
Install-directories window to the drive letter you selected in the available
space list box.
ΓòÉΓòÉΓòÉ 6.4. OK ΓòÉΓòÉΓòÉ
Select the OK push button to return to the Install-directories window with the
action indicated by the Change directories to selected drive checkbox.
Before selecting OK:
1. Select a drive with enough space for the components you are installing.
2. Select the Change directories to selected drive checkbox to update the
directories fields in the Install-directories window.
ΓòÉΓòÉΓòÉ 7. Install ΓòÉΓòÉΓòÉ
Use the Install window to see the following information about the product that
you selected to install:
Product name
The name of the product
Product number
The official product number assigned to the product
Version
The version, release, and modification number of the product
Feature
The feature number of the product
This window also allows you to set options to have your CONFIG.SYS file
automatically updated, if needed, by the product, and to indicate whether
files should automatically be overwritten without prompting if files currently
exist with the same names as the product files.
Select OK to install the product or select Cancel to exit the window and
return to the main menu.
ΓòÉΓòÉΓòÉ 7.1. Update CONFIG.SYS ΓòÉΓòÉΓòÉ
Select the Update CONFIG.SYS check box to have the needed variables added to or
modified in your CONFIG.SYS file to include the directories that the product is
installed in.
Note: A backup of your original CONFIG.SYS file is saved in CONFIG.BAK in the
drive and path of the CONFIG.SYS being modified.
If you do not select this choice, you must manually update your CONFIG.SYS
file. Refer to the product's installation instructions for additional
information on how to update your CONFIG.SYS file.
ΓòÉΓòÉΓòÉ 7.2. Overwrite files ΓòÉΓòÉΓòÉ
Select the Overwrite files check box in the Install window to automatically
replace all workstation files that have the same name and location as product
files being installed.
If you do not check this choice, the installation and maintenance utility
prompts you before overwriting an existing workstation file.
ΓòÉΓòÉΓòÉ 7.3. OK ΓòÉΓòÉΓòÉ
Select the OK push button in the Install window to install the selected
product.
When you select OK, the Installation and Maintenance Utility does the
following:
1. Transfers and parses the package file for the product, which provides
information to the installation and maintenance utility about how to
install the product.
2. Prompts you for the directories where you want to place the product
files.
ΓòÉΓòÉΓòÉ 8. Install-File Errors ΓòÉΓòÉΓòÉ
Use the Install-File Errors window to see the errors found in the transferred
catalog or package file.
System administrators:
1. Switch to the source location.
2. Edit the catalog or package file to correct the errors.
3. Select Retry.
Users:
Print the errors by selecting the Print push button, and then contact your
system administrator or product distributor.
ΓòÉΓòÉΓòÉ 8.1. Retry ΓòÉΓòÉΓòÉ
Select the Retry push button in the Install-File Errors window to transfer and
parse the catalog or package file again.
Select Retry after you edit the catalog or package file at the source to ensure
that your changes have corrected the problem.
ΓòÉΓòÉΓòÉ 8.2. Print ΓòÉΓòÉΓòÉ
Select the Print push button in the File Errors window to print the displayed
parse errors on the workstation printer.
Make sure that the workstation printer is on.
ΓòÉΓòÉΓòÉ 9. Install-directories ΓòÉΓòÉΓòÉ
Use the Install-directories window to specify the directories you want to
install the product in.
You can change the file directories to customize where the files are
transferred to on your workstation. Remember that the hard disks you specified
in the directories must have enough space available to store the transferred
files.
After you specify the directories, select the Install push button to start the
installation.
You can determine the amount of disk space a product requires and the amount of
disk space available for all your hard drives by selecting the Disk space push
button.
ΓòÉΓòÉΓòÉ 9.1. Install-directories ΓòÉΓòÉΓòÉ
Use the Install-directories window to specify the directories you want to
install the product in.
You can change the directories to customize where the files are transferred to
on your workstation. Remember that the hard disks specified in the directories
must have enough space available to store the transferred files.
Use the list box to select the components of the product you want to install.
You must select at least one component to continue.
After selecting the components, you can install them by selecting the Install
push button. You can also see how much disk space is required to install the
selected components by selecting the Disk space push button.
ΓòÉΓòÉΓòÉ 9.2. Install-directories ΓòÉΓòÉΓòÉ
One or more of the product's components have already been installed in the
specified directories. Use this window to install additional components of a
product in these same directories.
Use the list box to select the additional components of the product you want to
install. You must select at least one component to continue.
Select the Install push button to install the selected components. To see how
much disk space is required to install the selected components, select the Disk
space push button.
ΓòÉΓòÉΓòÉ 9.3. Directory ΓòÉΓòÉΓòÉ
Use the directory fields in the Install-directories window to enter the
directories where you want the product files installed.
The maximum directory length is 128 characters.
o Valid sample directories:
C:\IBMRM
D:\
D:\TOOLS\KEDIT
o Sample directories that are not valid:
\IBMRM
C:\TOOLONGPATH
C:\IBMRM\
ΓòÉΓòÉΓòÉ 9.4. Disk Space ΓòÉΓòÉΓòÉ
Select the Disk space push button in the Install-directories window to see the
amount of disk space required to install the product and the amount of free
space available on each workstation hard disk.
ΓòÉΓòÉΓòÉ 9.5. Install ΓòÉΓòÉΓòÉ
Select the Install push button in the Install-directories window to begin
installing the product in the specified directories.
ΓòÉΓòÉΓòÉ 9.6. Component ΓòÉΓòÉΓòÉ
Use the Component list box in the Install-directories window to look at a list
of the installable components for the selected product if your product has
components.
Select the components you want to install. Next, select the Install push
button to begin installation or select the Disk space push button to see how
much workstation disk space the selected components require.
ΓòÉΓòÉΓòÉ 10. Update ΓòÉΓòÉΓòÉ
Use the Update window to see the following information about the product that
you selected to update:
Product name
The name of the product
Product number
The official product number assigned to the product
Version
The version, release, and modification number of the product
Feature
The feature number of the product
Select Update CONFIG.SYS to automatically update your CONFIG.SYS file.
Select Save a backup version to save backup copies of files that have changed
into a backup directory. This option enables the Restore action so that the
current service level can be restored at a later date. You can execute a
restore if the new service level for the product results in some undesired
behavior. Do not select this option if disk space is not available to store
the backup files.
Note: The backup version of the product files can be deleted later by using
the Delete choice on the Action pull-down.
Select Update to update the product or select Cancel to exit the window. If
the product has components, the update affects all installed components for
which an update exists. You can look at a list of the installed components in
the Product status window.
ΓòÉΓòÉΓòÉ 10.1. Save a backup version ΓòÉΓòÉΓòÉ
Select the Save a backup version check box in the Update window to save a
backup version of any files that are replaced during the update.
Selecting this option enables you to restore the current version of the product
after the update is done. Do not select this option if disk space is not
available to store these backup files.
Note: If this option is selected, the saved backup can be deleted at a later
date by using the Delete only the backup versions option on the Delete
window.
ΓòÉΓòÉΓòÉ 10.2. Update ΓòÉΓòÉΓòÉ
Select the Update push button in the Update window to update the selected
product.
When you select Update, the installation and maintenance utility does the
following:
1. Transfers and parses the package file for the product
2. Begins to update the product by replacing the product files with the
newer level files
ΓòÉΓòÉΓòÉ 10.3. Progress (Install or Update) ΓòÉΓòÉΓòÉ
Use the Progress window to look at the progress of files being transferred
during an install or update. This window contains:
Title line
The product name and component of the product being installed or updated
Progress box
Information on the progress of the installation or update
Status
The current status of the installation or update. The possible values for
this field are:
Processing
The installation and maintenance utility is performing a task that
may take an extended period of time
Error occurred
An error occurred. Press the Stop push button to cancel the
installation or update
Transferring
The program is transferring files
Unpacking
Files are being decompressed
Deleting files
Files are being deleted after you selected Stop during the
installation or update
Restoring files
Files are being restored to the previous service level after you
selected Stop
Elapsed time
The time that has elapsed since the file transfer began
Thermometer
A graphic representation of the number of files already transferred
Files box
Information about the file that is currently being transferred
Source
The name of the file at the source
Target
The name of the target file on the workstation
ΓòÉΓòÉΓòÉ 10.4. Stop ΓòÉΓòÉΓòÉ
Select the Stop push button on the Progress window to stop the install or
update.
ΓòÉΓòÉΓòÉ 11. Restore ΓòÉΓòÉΓòÉ
Use the Restore window to see the following information about the product that
you selected to restore to the previous service level:
Product name
The name of the product
Product number
The official product number assigned to the product
Version
The version, release, and modification number of the product
Feature
The feature number of the product
Restore removes the last service level applied and returns the product to its
previous level. If the product has components, Restore removes the last
service level from those components that have backups and returns them to
their previous levels. Any component without a backup is left at its current
level.
You can look at the applied service levels for this product or its components
by selecting the Service level push button on the Product status window.
Select Restore to restore the product to the previous service level, or select
Cancel to exit the window.
ΓòÉΓòÉΓòÉ 11.1. Restore ΓòÉΓòÉΓòÉ
Select the Restore push button in the Restore window to restore the product to
the previous service level.
When you select Restore, the installation and maintenance utility copies the
back up files of the previous service level over the current service level
files.
Warning: Selecting Restore overwrites the current service level.
ΓòÉΓòÉΓòÉ 12. Delete ΓòÉΓòÉΓòÉ
Use the Delete window to see the following information about the product that
you selected to delete:
Product name
The name of the product
Product number
The official product number assigned to the product
Version
The version, release, and modification number of the product
Feature
The feature number of the product
Select the Delete push button to delete the product and any backup versions of
the product.
If you select the Delete only the backup versions check box, only the backup
version of the product will be deleted. The current version will not be
deleted in this case.
ΓòÉΓòÉΓòÉ 12.1. Delete ΓòÉΓòÉΓòÉ
Select the Delete push button in the Delete window to delete the selected
product or components.
Warning: Selecting Delete destroys both the current and any saved backup
levels of the selected product unless you also select the Delete only the
backup versions check box.
ΓòÉΓòÉΓòÉ 13. Description ΓòÉΓòÉΓòÉ
Use this window to look at a description of a catalog file or a product. You
can vertically scroll the window by using the scroll bar or the arrow keys.
You can also size the window, in which case the text within the window is
automatically reflowed to the new window size.
ΓòÉΓòÉΓòÉ 13.1. Directories installed in ΓòÉΓòÉΓòÉ
This section of the window lists the directories that the product was installed
in. You cannot edit the fields, but you can scroll them so that paths that are
too long to be displayed in the available space can be seen.
ΓòÉΓòÉΓòÉ 13.2. Service level ΓòÉΓòÉΓòÉ
This push button displays the Service level window so you can determine the
service level of the product.
ΓòÉΓòÉΓòÉ 13.3. Service level ΓòÉΓòÉΓòÉ
This push button displays the Service level window so you can determine the
service level of the selected component.
This push button is disabled until a component is selected in the Currently
installed list box.
ΓòÉΓòÉΓòÉ 13.4. Currently installed components ΓòÉΓòÉΓòÉ
This list box contains the components that have been installed for the
specified product. Select a component in the list and then select the Service
level push button if you want to see the current service level of a component.
ΓòÉΓòÉΓòÉ 14. Product status ΓòÉΓòÉΓòÉ
Use the Product status window to look at information about a product that is
currently installed on the workstation. The following information is
displayed:
Product name
The name of the selected product that is currently installed on the
workstation
Product number
The official product number assigned to the selected product
Version
The version, release, and modification number of the selected product
Feature
The feature number of the selected product
Components currently installed
The names of the components that have already been installed on the
workstation for the product
Directories installed in
The directories where the product was installed
You can determine the service level of any component by selecting the
component in the Currently installed list box and then selecting the Service
level push button. The Service level window is then displayed.
ΓòÉΓòÉΓòÉ 14.1. Service level ΓòÉΓòÉΓòÉ
This window displays a list of the service levels that have been applied to the
indicated product or component, along with the date each one was applied (by
the Update action) and the location that it was applied from.
The displayed information can be printed by selecting the Print push button.
ΓòÉΓòÉΓòÉ 14.2. Service level list ΓòÉΓòÉΓòÉ
This is a list of service levels that have been applied to the indicated
product or component. The list also contains the date that each level was
applied (by the Update action) and the origin of each service level update.
The origins that can be displayed are:
MVS The service level was applied from an MVS host system.
VM The service level was applied from a VM host system.
VSE The service level was applied from a VSE host system.
Drive The service level was applied from a diskette drive, a CD ROM drive,
LAN drive, or AS/400 PC support folder.
ΓòÉΓòÉΓòÉ 14.3. Print ΓòÉΓòÉΓòÉ
Prints a record of the service level information currently displayed on the
Service level window.
ΓòÉΓòÉΓòÉ 14.4. Cancel ΓòÉΓòÉΓòÉ
Select the Cancel push button to close the Service level window and return to
the Product status window.
ΓòÉΓòÉΓòÉ 15. Search ΓòÉΓòÉΓòÉ
Use the Search window to search the system for catalog files.
To search for catalog files:
1. Select the drive that you want to search from the Drive combination box.
When you select a drive, the Directories and File list boxes are updated
to reflect the directories and file names on the selected drive.
2. If you want to specify a file qualification to search for, enter a file
name in the Catalog filename entry field that contains wildcard
characters. The default qualification is *.ICF.
3. Begin searching by selecting the directory that you want to search in the
Directories list box. Selecting the directory causes the File list box to
be updated with a list of files from the directory that matches the
specified file qualification.
Continue selecting directories until you find the catalog file you want
in the File list box.
4. Select the desired catalog file from the File list box.
5. Select OK. The catalog file name you selected is placed in the Open drive
catalog window.
ΓòÉΓòÉΓòÉ 15.1. Catalog filename ΓòÉΓòÉΓòÉ
Use this entry field to enter the name of the catalog file you want to open.
You can use wildcard characters in the catalog file name.
You can also specify a catalog file name by selecting an item in the File list
box.
ΓòÉΓòÉΓòÉ 15.2. Drive ΓòÉΓòÉΓòÉ
This combination box specifies the drive that is to be searched. If you select
a new drive from the list of drives, the Directories and File list boxes are
updated to reflect the directories and files that exist on the selected drive.
ΓòÉΓòÉΓòÉ 15.3. File ΓòÉΓòÉΓòÉ
This list box contains a list of the files that exist on the drive and
directory you are searching. The file names contained in this list box match
the wildcard specification that appears in the Catalog filename entry field.
You can specify the catalog file you want to open by selecting an item in this
list.
You can scroll the File list box horizontally and vertically.
ΓòÉΓòÉΓòÉ 15.4. Directory ΓòÉΓòÉΓòÉ
This list box contains a list of the directories on the drive you want to
search. You can scroll the Directory list box horizontally and vertically.
To use this list box, select the directory that you want to search. The files
in that directory appear in the File list box. Selecting a directory also
causes the subdirectories in it to be displayed in the Directories list box.
ΓòÉΓòÉΓòÉ 15.5. OK ΓòÉΓòÉΓòÉ
Select this push button to return to the Open drive catalog window. The catalog
file name you selected is placed in the filename field.
ΓòÉΓòÉΓòÉ 16. Insert disk ΓòÉΓòÉΓòÉ
The Insert disk window is used for products that have more than one
installation diskette. This window appears on top of the current window
whenever a new disk needs to be inserted during a drive installation.
ΓòÉΓòÉΓòÉ 16.1. Drive ΓòÉΓòÉΓòÉ
Use this drop-down combination box to specify the drive where you insert the
requested diskette. The box contains a list of all available drives. The drive
selected by default is the one currently being used. If you have two diskette
drives, you can insert two diskettes and use this combination box to switch
between drives.
ΓòÉΓòÉΓòÉ 16.2. Continue ΓòÉΓòÉΓòÉ
Select this push button to continue with the installation or update. The
selected drive is checked to ensure it contains the requested disk. If it does
not, this window is displayed again.
ΓòÉΓòÉΓòÉ 16.3. Delete only the backup versions ΓòÉΓòÉΓòÉ
Select the Delete only the backup versions check box on the Delete window to
delete only the backup versions of the selected product or components. The
files for the current version will not be deleted.
This check box is disabled if there is no backup version to delete.
ΓòÉΓòÉΓòÉ 17. Delete ΓòÉΓòÉΓòÉ
Use the Delete window to look at the following information about the product
that you selected to delete:
Product name
The name of the product
Product number
The official product number assigned to the product
Version
The version, release, and modification number of the product
Feature
The feature number of the product
Components
The list of installed components for the selected product
Use the list to select the components to be deleted, then select the Delete
push button to delete the selected components. Any backup versions of the
selected components will also be deleted.
If you select the Delete only the backup versions check box, only the backup
versions of the selected components will be deleted. The current version will
not be deleted in this case.
ΓòÉΓòÉΓòÉ 17.1. Components ΓòÉΓòÉΓòÉ
Use the Component list box in the Delete window to select the installed
components to be deleted for the selected product.
Each selected component in the list is deleted, along with any backup versions
of the components, unless the Delete only the backup versions check box is
selected. Select the components in the list, then select the Delete push
button to begin deleting the components.
ΓòÉΓòÉΓòÉ 17.2. Select all ΓòÉΓòÉΓòÉ
The Select all push button selects all items displayed in the list box. This
push button is disabled if all the components in the list box are selected.
ΓòÉΓòÉΓòÉ 17.3. Deselect all ΓòÉΓòÉΓòÉ
The Deselect all push button deselects all items displayed and selected in the
list box. This push button is disabled if none of the components is selected.
ΓòÉΓòÉΓòÉ 18. Progress (Restore or Delete) ΓòÉΓòÉΓòÉ
Use the Progress window to look at the progress of files being restored or
deleted. This window contains:
Title line
The product name and component of the product being restored or deleted
Progress box
Information on the progress of the operation
Status
The current status of the restore or delete. The possible values for this
field are:
Processing
The installation and maintenance utility is executing a task that can
take an extended period of time
Error occurred
An error occurred. Press the Stop push button to cancel the
operation
Deleting files
The program is deleting the product files
Restoring files
Files are being restored to the previous service level
Elapsed time
The time that has elapsed since the operation began
Thermometer
A graphic representation of the number of files already restored or deleted
ΓòÉΓòÉΓòÉ 18.1. Descriptions ΓòÉΓòÉΓòÉ
The Descriptions push button displays a Descriptions window that contains a
brief description of each selected component in the list box. If a description
is not available, the window is displayed with text stating that the
description is not available to be displayed.
The Descriptions push button is only available when a component is selected.
ΓòÉΓòÉΓòÉ 18.2. Stop ΓòÉΓòÉΓòÉ
Select the Stop push button on the Progress window to stop the restore or
delete.
ΓòÉΓòÉΓòÉ 19. Error messages ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ 19.1. Help for EPFIE107 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot find the package file specified
in the catalog file, or it cannot open the package file after it was
transferred to the workstation.
Response
Users
Ensure that you have access to the data set (MVS), are linked to the mini disk
(VM), have the correct diskette inserted, or have accessed the LAN drive that
contains the product files. Select Retry to try the transfer again. If the
error persists, report the error to your system administrator.
Select Cancel to remove the message and return to the previous window.
System administrators
Check that the package file for this product exists at the source and that the
Package entry in the catalog file is pointing to the correct package file.
Correct any errors, and try again.
Select Cancel to remove the message and return to the previous window.
ΓòÉΓòÉΓòÉ 19.2. Help for EPFIE111 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while the installation and maintenance utility initialized
communications with the host.
Response
1. Select Cancel to remove the message and return to the previous window.
2. Check that the host session specified in the Open host catalog window is
active and ready to accept input. If you are attempting an Install or
Update action, open the host catalog again using the Open host catalog
choice on the File menu.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.3. Help for EPFIE112 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot transfer the specified file.
The corresponding workstation file is in use.
Response
Do one of the following:
o Close the workstation application that is using the file, and select
Retry.
o If the file being transferred is a Workplace Shell* object or class DLL,
you must de-register the class and start your workstation again to free
the file.
o Select Cancel to cancel the installation or update of this product.
ΓòÉΓòÉΓòÉ 19.4. Help for EPFIE113 ΓòÉΓòÉΓòÉ
Explanation
The host session specified in the Open host catalog window is not responding to
the installation and maintenance utility commands.
Response
o Switch to the host session and verify that the host session is available
and ready to accept commands.
o Ensure that you selected the correct host operating system in the Open
host catalog window. You can select one of the following:
Cancel Cancels the entire operation
Retry Issues the RECEIVE commands again
ΓòÉΓòÉΓòÉ 19.5. Help for EPFIE114 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot find a specified file at the
source.
Response
Users
Ensure that the file exists at the source and select Retry or select Cancel.
If the problem persists, contact your system administrator.
System administrators
Ensure that the file exists at the source and that the catalog and package
files for the product point to the correct files.
ΓòÉΓòÉΓòÉ 19.6. Help for EPFIE115 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot find the information necessary
to delete or restore the selected product. Most likely, the product files were
deleted without using the Delete or Restore actions of the installation and
maintenance utility.
Response
1. Select Cancel to cancel the Restore or Delete.
2. If the product files are still on your hard drive, you can delete them
using the OS/2* DELETE command. To restore the product, copy the files
from the backup subdirectory using the OS/2 COPY command.
ΓòÉΓòÉΓòÉ 19.7. Help for EPFIE116 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility found errors while attempting to parse
the backed-up package file.
A valid package file is required to restore or delete the installed service
level.
Response
1. Select Cancel to cancel the Delete or Restore.
2. To delete the product, manually delete the files using the OS/2* DELETE
command. To restore the product, manually copy the files from the backup
subdirectory using the OS/2 COPY command.
ΓòÉΓòÉΓòÉ 19.8. Help for EPFIW124 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot find the file specified in the
package file to be deleted. As a result, it has not been deleted.
This will not interfere with the installation or update.
Response
Select OK to continue the operation.
ΓòÉΓòÉΓòÉ 19.9. Help for EPFIQ125 ΓòÉΓòÉΓòÉ
Explanation
Due to cancellation or an error, the installation and maintenance utility
transferred only part of the files necessary to run the product.
Response
Select one of the following:
Yes
Deletes the transferred files. Select Yes if you do not want to try the
installation again.
No
Leaves the files on the workstation. The transferred files do not have to
be transferred again when installation is restarted. Select No if you want
to try the installation again.
When you restart the install utility again, it will continue to download the
files that were not previously downloaded.
ΓòÉΓòÉΓòÉ 19.10. Help for EPFIW127 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot access the file specified
because it exists on a disk whose format is not readable.
Response
1. Select Cancel to stop the operation.
2. Ensure that the specified file is properly formatted.
3. Start the operation again.
ΓòÉΓòÉΓòÉ 19.11. Help for EPFIW128 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot delete the workstation file
specified because it is in use.
Response
1. Select Cancel to remove this message.
2. Ensure that the product you are attempting to install, update, delete, or
restore is not running. If the file being transferred is a Workplace
Shell* object or class DLL, you must de-register the class and restart
your workstation to free the file.
3. Wait until the specified file is free, or end the program that is using
the file.
4. Start the operation again.
ΓòÉΓòÉΓòÉ 19.12. Help for EPFIE129 ΓòÉΓòÉΓòÉ
Explanation
There is insufficient space on the hard disk to transfer any more files.
Response
1. Make space on the hard disk by removing unnecessary files.
2. Select Update or Install from the Action menu to start the transfer
again.
If you are attempting an update, you may want to cancel the selection of
the Save a backup version check box when you try the update again to save
space on the hard disk.
or
1. Select Cancel to end the install or update.
2. Install the product on a different drive, or remove unnecessary files
from the current drive.
ΓòÉΓòÉΓòÉ 19.13. Help for EPFIE130 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot transfer the specified file
because the target workstation disk is not readable or is not formatted with
the correct file system. This can be caused if a file with a High Performance
File System (HPFS) name or extension is transferred to a drive formatted with
the FAT file system.
Response
1. Select the Retry push button.
2. Format the hard disk again if the error persists or select a different
drive as the target location.
ΓòÉΓòÉΓòÉ 19.14. Help for EPFIE131 ΓòÉΓòÉΓòÉ
Explanation
Another program is using the specified file. The installation and maintenance
utility is unable to overwrite or modify the file.
Response
1. Ensure that the program you are installing or updating is not running.
2. End any programs that are accessing the file. If the file being
transferred is a Workplace Shell* object or class DLL, you must
de-register the class and restart your workstation to free the file.
3. Select Retry.
ΓòÉΓòÉΓòÉ 19.15. Help for EPFIE132 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility was not able to create the directories
in the reported path. A file with the specified name may already exist.
Response
1. Select Cancel to stop the operation.
2. Ensure that sufficient disk space is available on the reported hard drive
to create the directories.
3. Depending on which of the following conditions caused the error, apply
the corrective response:
o A directory named EPFICAT.PKG exists as a subdirectory in the
<boot_drive>:\OS2\SYSTEM\$EPFINST path or in the
<boot_drive>:%EPFINSTDIR% path if the installation variable
EPFINSTDIR is set.
- Delete the EPFICAT.PKG from the $EPFINST directory with the
OS/2 DEL command.
- Remove the EPFICAT.PKG directory with the OS/2 RD command.
o A file with the same name as one of the directories already exists.
- Ensure that a file with the target directory name does not
already exist.
o The EPFINSTDIR environment variable is set to an incorrect directory
name.
- Ensure that the directory names are valid for the type of file
system on the drive.
4. Try the action again.
ΓòÉΓòÉΓòÉ 19.16. Help for EPFIQ133 ΓòÉΓòÉΓòÉ
Explanation
You are attempting to cancel the delete or restore operation in the middle of
execution. Doing this would leave the product in an unstable state. If you
proceed with the cancellation, do not use the product until you install or
update it again.
Response
Select one of the following:
Yes Cancels the operation
No Continues with the delete or restore in progress
ΓòÉΓòÉΓòÉ 19.17. Help for EPFIE134 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot read the specified profile
file. Information that is critical for the current operation is stored in this
file.
Without this information the operation cannot be performed.
Response
1. Select Cancel to cancel the operation.
2. Make sure the specified file is not locked by another process and try the
operation again. If the error persists, delete the profile file, and try
the operation again.
ΓòÉΓòÉΓòÉ 19.18. Help for EPFIE137 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot copy the specified file to the
backup directory. This could be because:
o There is insufficient disk space to back up the specified file
o The specified file already exists and is in use
o The backup directory could not be created
Response
1. Select Cancel to cancel the operation.
2. Ensure that there is sufficient disk space available on the drive
containing the backup directory.
3. Try the update again.
ΓòÉΓòÉΓòÉ 19.19. Help for EPFIW138 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while the installation and maintenance utility attempted to
set the date and time of the transferred file to the date and time specified in
the package file.
The date and time do not need to be set for the installation to be successful.
The date and time of the file has been set to the current system date and time.
Response
Select OK to continue.
ΓòÉΓòÉΓòÉ 19.20. Help for EPFIQ139 ΓòÉΓòÉΓòÉ
Explanation
To transfer the specified file, the installation and maintenance utility needs
to replace an existing workstation file. To avoid this message for each
duplicate file, select Yes to all.
Response
Select one of the following:
Yes
Replaces the existing workstation file and continues with the installation
or update.
No
Does not replace the file. The installation or update continues.
Yes to all
Replaces the existing workstation file and all subsequent duplicate files
found on the workstation. This message will not be redisplayed.
The installation or update continues.
ΓòÉΓòÉΓòÉ 19.21. Help for EPFIE140 ΓòÉΓòÉΓòÉ
Explanation
The path you entered is not a valid path name.
Response
1. Select Cancel to return to the Install-directories window.
2. Correct the path. Ensure that:
o The path contains a valid hard drive
o The directory names are all less than or equal to 8 characters
(unless the drive is formatted with the HPFS file system)
o The path does not end with a back slash (\)
3. Select the Install push button to try again.
ΓòÉΓòÉΓòÉ 19.22. Help for EPFIW141 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while the installation and maintenance utility attempted to
set the read-only or hidden attribute of the specified file. Setting this
information is not required to successfully install the product. The attribute
has not been set.
Response
Select OK to continue with the operation.
ΓòÉΓòÉΓòÉ 19.23. Help for EPFIE142 ΓòÉΓòÉΓòÉ
Explanation
An operating system error occurred while installing, updating, or restoring the
specified files. This could be because:
o Insufficient disk space is available to copy the files.
o One or more of the files being copied already exists and is in use.
Response
1. Check the amount of disk space on the hard disk that the product is
installed on.
2. Ensure that the product is not currently running.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.24. Help for EPFIE144 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot load or find the DLL needed to
continue.
Response
1. Select OK to remove the message.
2. Check that the specified DLL is in a directory in the LIBPATH. If the
install transfers the DLL, it may be necessary to add a period and
semicolon (.;) to the beginning of the LIBPATH statement in the
CONFIG.SYS file (for example, LIBPATH=.;C:\OS2\DLL;).
3. Start the workstation again, and then try the installation again.
If the DLL is part of the installation and maintenance utility, ensure
that it is on the same directory as all the other installation files.
ΓòÉΓòÉΓòÉ 19.25. Help for EPFIE145 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot find the function specified in
an EXIT keyword of a FILE entry within the specified DLL.
Response
Users
This problem is most likely caused by a problem with the product you are
attempting to install or update. Contact your system administrator.
System administrators
1. Select OK to remove the message.
2. Check the validity of the package file.
3. If the error persists, contact the product service representative.
ΓòÉΓòÉΓòÉ 19.26. Help for EPFIE147 ΓòÉΓòÉΓòÉ
Explanation
The specified path does not contain a valid hard drive.
Response
1. Select Cancel to return to the Install-directories window.
2. Add the appropriate drive to the path.
3. Select the Install push button to try again.
ΓòÉΓòÉΓòÉ 19.27. Help for EPFIE148 ΓòÉΓòÉΓòÉ
Explanation
The disk specified in the path does not exist or is not a hard disk.
Response
1. Select Cancel to return to the Install-directories window.
2. Change the drive specification of the path.
3. Select the Install push button to try again.
ΓòÉΓòÉΓòÉ 19.28. Help for EPFIE149 ΓòÉΓòÉΓòÉ
Explanation
You cannot use wildcard characters (? and *) in the path specifications for
this window.
Response
1. Select Cancel to return to the Install-directories window.
2. Remove these characters from the path.
3. Select Install to try again.
ΓòÉΓòÉΓòÉ 19.29. Help for EPFIE150 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot transfer the file specified
because there are too many files in the directory.
Response
1. Delete unnecessary files from the directory.
2. Select Retry.
or
1. Select Cancel.
2. Start again using a new target directory.
ΓòÉΓòÉΓòÉ 19.30. Help for EPFIE151 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility detected an error while communicating
with the host.
Response
1. Check the state of the host session.
2. Select Retry.
For more information on this error code, refer to the OS/2 User's Guide and
look up the corresponding TRANSxxx returncode.
If the error persists, contact the product service representative.
ΓòÉΓòÉΓòÉ 19.31. Help for EPFIE152 ΓòÉΓòÉΓòÉ
Explanation
The host session selected in the Host session list box on the Open host catalog
window is not valid.
Response
1. Ensure that the specified host session is active.
2. Try the operation again.
or
1. Select Open Catalog-Host from the File menu.
2. Open the product catalog again using a different host session.
ΓòÉΓòÉΓòÉ 19.32. Help for EPFIE153 ΓòÉΓòÉΓòÉ
Explanation
The host session being used for file transfer is already transferring a file or
is being used by another session.
Response
1. Wait until the host session is no longer busy.
2. Select Retry to try the operation again.
ΓòÉΓòÉΓòÉ 19.33. Help for EPFIE155 ΓòÉΓòÉΓòÉ
Explanation
EHLLAPI reported a system error. This can be due to a number of communications
problems, such as the controller is not working or the cable was unplugged.
Response
Check your communications setup, and try the install or update again.
If the error persists, start the system again, and try the install or update
again.
ΓòÉΓòÉΓòÉ 19.34. Help for EPFIE156 ΓòÉΓòÉΓòÉ
Explanation
The window the host session runs in is active, but the workstation is not
connected to the host.
Response
1. Ensure that host communication is established and that the host is ready
to accept input.
2. Try the operation again.
ΓòÉΓòÉΓòÉ 19.35. Help for EPFIE157 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while the installation and maintenance utility tried to add
the specified path to the operating system configuration file (CONFIG.SYS).
Response
1. Select OK to allow the installation or update to continue.
2. Add the proper paths to the CONFIG.SYS file. See the product
installation instructions for more information.
You can find a backup of the original CONFIG.SYS file in CONFIG.BAK, in
the drive and path where the product was installed.
ΓòÉΓòÉΓòÉ 19.36. Help for EPFIE158 ΓòÉΓòÉΓòÉ
Explanation
An error occurred when the installation and maintenance utility tried to add
the specified folder to the Workplace Shell.*
Response
Select OK to continue transferring the files.
You can add the group to the Workplace Shell after installation is complete.
ΓòÉΓòÉΓòÉ 19.37. Help for EPFIE159 ΓòÉΓòÉΓòÉ
Explanation
An error occurred when the installation and maintenance utility tried to add
the specified program name to the Workplace Shell.* The program name may
already exist in the designated folder.
Response
Select OK to continue adding the remaining files.
You can add the program to the Workplace Shell after installation is complete.
Refer to the OS/2* documentation for information on adding programs to the
Workplace Shell.
ΓòÉΓòÉΓòÉ 19.38. Help for EPFIQ160 ΓòÉΓòÉΓòÉ
Explanation
The service level of the selected product is the same as the service level of
the product already installed on your workstation.
The product has already been updated to the most recent service level. It is
not necessary to update the product again.
Response
Select one of the following:
Yes Continues to update the product
No Cancels the update
ΓòÉΓòÉΓòÉ 19.39. Help for EPFIE161 ΓòÉΓòÉΓòÉ
Explanation
The operating system of the host session specified in the Open host catalog
window does not match the operating system you are using.
Response
From the Open host catalog window, ensure that the host session and host
operating system match. Then try the operation again.
ΓòÉΓòÉΓòÉ 19.40. Help for EPFIE162 ΓòÉΓòÉΓòÉ
Explanation
You do not have authorization to write to the drive you specified.
Response
Change the drive and try again or contact your system administrator for
authorization.
ΓòÉΓòÉΓòÉ 19.41. Help for EPFIE163 ΓòÉΓòÉΓòÉ
Explanation
The system requires additional system resources or system memory for this
installation program.
Response
1. Select Cancel to cancel the entire operation.
2. End any unnecessary applications, and exit any unnecessary sessions.
3. Try again.
ΓòÉΓòÉΓòÉ 19.42. Help for EPFIE165 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility is not able to execute the specified
program.
If this executable file is part of the installation product, it must be in the
same directory as all the other installation and maintenance utility files.
Response
1. Select Cancel to remove the message box and return to the previous
window.
For more information on the DOS return code reported, refer to the OS/2
2.0 Toolkit Control Program Reference.
2. Exit the installation program.
3. Change to the directory that holds the installation executable files.
4. Start the installation program again.
or
1. Select Cancel to remove the message box and return to the previous
window.
2. Add the directory containing the installation executable files to the
path statement in the CONFIG.SYS file.
3. Start the system again.
4. Start the installation program again.
ΓòÉΓòÉΓòÉ 19.43. Help for EPFIE166 ΓòÉΓòÉΓòÉ
Explanation
The catalog file at the source contains too many products. No more than 80
product packages are allowed in the catalog file.
Response
Users
1. Select Cancel to remove the message box.
2. Contact your system administrator.
System Administrators
Do one of the following:
o Edit the catalog file on the host, and delete unnecessary products.
o Split the catalog file into two or more catalog files.
ΓòÉΓòÉΓòÉ 19.44. Help for EPFIE167 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot find the catalog file at the
source. This could be because:
o The specified file does not exist.
o You do not have access to the MVS data sets, the VM mini disks, the LAN
drives, or the correct diskettes that contain the catalog file.
Response
Select Cancel to remove the message box and return to the previous window.
Do one of the following:
o Contact your system administrator if the specified file does not exist at
the source.
o Access the MVS data sets, the VM mini disks, the LAN drives, or the
correct diskettes that contain the catalog.
ΓòÉΓòÉΓòÉ 19.45. Help for EPFIE168 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility encountered a syntax error while
parsing the specified catalog file.
Response
Users
1. Select Cancel to remove the message box and return to the Open window.
2. Ensure that the catalog file name specified on the Open window is a valid
catalog file name.
3. If the error persists, report the problem to your system administrator.
System administrators
1. Fix the syntax error in the source copy of the host configuration file.
2. Select Cancel to remove the message box and return to the Open window.
3. Try Open again.
ΓòÉΓòÉΓòÉ 19.46. Help for EPFIF169 ΓòÉΓòÉΓòÉ
Explanation
The maximum number of open files allowed by the system has been exceeded.
Transferring the specified file requires opening a new file.
Response
1. Close any applications that use a large number of files.
2. Try the operation again.
If the error persists, start the system again and restart the installation
program.
ΓòÉΓòÉΓòÉ 19.47. Help for EPFIE171 ΓòÉΓòÉΓòÉ
Explanation
Too many transmission errors have occurred during the file transfer.
This situation can be caused by a faulty communication line.
Response
Try the operation again. If the error persists, call a service person to check
the communications channel.
ΓòÉΓòÉΓòÉ 19.48. Help for EPFIE172 ΓòÉΓòÉΓòÉ
Explanation
The host is waiting for you to issue a reset. Communication cannot proceed
unless you issue a reset or the timeout interval expires.
Response
1. Switch to the host session.
2. Issue a reset.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.49. Help for EPFIQ173 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility transferred only part of the files
specified in the package file that are necessary to update the product. You
cannot use the product as it is.
Response
Select one of the following:
Yes
Restores the product to the state it was in before the update began. Select
Yes if you do not plan to try the update again.
No
Leaves the files as they are. Select No if you plan to try the update
again. This saves time when you run the installation or update again.
ΓòÉΓòÉΓòÉ 19.50. Help for EPFIQ174 ΓòÉΓòÉΓòÉ
Explanation
You have requested to exit the installation and maintenance utility.
Response
Select one of the following:
Yes Exits the utility
No Returns you to the main window without exiting
ΓòÉΓòÉΓòÉ 19.51. Help for EPFIF175 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility failed due to insufficient system
resources.
Response
Close any unnecessary applications, and select Retry.
Select Cancel if you want to leave the application.
ΓòÉΓòÉΓòÉ 19.52. Help for EPFIE176 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility failed to create a Presentation
Manager* window. This error could be caused by insufficient system resources or
a lack of available memory.
Response
o Select Cancel.
o Cancel any unnecessary applications and close any unnecessary sessions.
o Try the operation again.
ΓòÉΓòÉΓòÉ 19.53. Help for EPFII177 ΓòÉΓòÉΓòÉ
Explanation
The action you requested has completed. You must restart your operating system.
Response
Shut down and restart your system.
ΓòÉΓòÉΓòÉ 19.54. Help for EPFII178 ΓòÉΓòÉΓòÉ
Explanation
The action you requested has stopped. You must restart your operating system
and retry the requested action.
Response
o Respond to any other messages from the application.
o Shut down and restart your system.
o Retry the action that stopped.
ΓòÉΓòÉΓòÉ 19.55. Help for EPFIE180 ΓòÉΓòÉΓòÉ
Explanation
The product description file is not available at the source, or the file name
specified by the PKGDESCRFILE keyword in the catalog file is incorrect.
Response
Users
Ensure that you have access to the appropriate VM mini disks, MVS data sets,
LAN drives, or diskettes and select one of the following:
Retry
Attempts to transfer the product description file again
Cancel
Removes the message box and returns to the main window
System administrators
Ensure that the file name specified by the PKGDESCRFILE keyword in the catalog
file is correct and that the file exists at the source.
ΓòÉΓòÉΓòÉ 19.56. Help for EPFIQ181 ΓòÉΓòÉΓòÉ
Explanation
If you have not selected the Save a backup version option, then you cannot
restore the product to the previous service level after the Update is
completed. Also, if you do not select this option, and an unrecoverable error
occurs during the update, the product will not be restored to a stable service
level.
Select the Save a backup version option unless workstation disk space is
limited. Using this option guarantees that the product can be restored to a
stable service level if an error occurs.
Response
Select one of the following:
Yes
Continues with the update without saving a backup version
No
Removes the message box and returns you to the Update window where you can
select the Save a backup version option
ΓòÉΓòÉΓòÉ 19.57. Help for EPFIE183 ΓòÉΓòÉΓòÉ
Explanation
One or more of the parameters specified is not valid for a user exit. A problem
occurred when parsing the argument variables.
Response
Users
Tell the system administrator that there is a problem in the package file of
the selected product.
System administrators
Examine the specified exit parameters, and correct any errors in the product's
package file.
ΓòÉΓòÉΓòÉ 19.58. Help for EPFIQ184 ΓòÉΓòÉΓòÉ
Explanation
One of the selected components cannot operate correctly unless you also install
another component.
Response
Select one of the following:
Yes
Installs the component required for correct operation
No
Removes the message box and returns you to the Install-directories window
ΓòÉΓòÉΓòÉ 19.59. Help for EPFIQ185 ΓòÉΓòÉΓòÉ
Explanation
The specified drive in the File directory field does not contain enough free
disk space to hold the product that you are attempting to install.
Response
Select one of the following:
Yes
Ignores the warning and continues with the installation. This can result in
an unsuccessful installation because of the lack of free disk space.
No
Removes the message box and returns to the Install-directories window.
After returning, perform one of the following actions:
1. Select a new drive to install the product on by changing the drive
specification in the File directory field. To try to find a disk with
enough space, select the Disk space push button.
2. If the product contains components, select fewer components and select
the Install push button again.
Note: Only the selected components are installed.
ΓòÉΓòÉΓòÉ 19.60. Help for EPFIQ186 ΓòÉΓòÉΓòÉ
Explanation
You selected to not have the CONFIG.SYS file automatically updated. If the
product you are installing or updating requires changes in the CONFIG.SYS file,
the product will not run correctly after the installation or update is complete
unless you make the necessary changes and restart your system.
Response
Select one of the following:
Yes
Installs the product without updating the CONFIG.SYS file. When the product
installation or update has successfully completed, you must manually update
the CONFIG.SYS file, if this is required by the product, before it can be
run.
The information that must be added to the CONFIG.SYS will be written to a
file named CONFIG.ADD in the same directory as your current CONFIG.SYS. You
should replace your current CONFIG.SYS with the CONFIG.ADD file.
No
Removes the message box and returns to the previous window where you can
select the Update CONFIG.SYS option and then restart the installation or
update.
ΓòÉΓòÉΓòÉ 19.61. Help for EPFIE187 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while running a routine provided by the product you are
installing, updating, or restoring.
Response
Record the return code and select Cancel to exit the installation or update.
Refer to the installation instructions of the product that you are installing
for more information about the return code.
If the error persists, contact your system administrator or your product
service representative.
ΓòÉΓòÉΓòÉ 19.62. Help for EPFIE188 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while attempting to access the file at the source. One of the
following conditions can cause this error:
o Another program or user is accessing the file or the data set containing
the file.
o The specified file or data set does not exist at the source.
Response
1. If a host is the source, switch to the host emulator window and check the
host screen for any error messages.
2. Ensure that the specified file or data set exists.
3. Return to the workstation session, and try the operation again by
selecting the Retry push button.
If the error persists, wait until the host file is not in use, and try the
operation again.
ΓòÉΓòÉΓòÉ 19.63. Help for EPFIE189 ΓòÉΓòÉΓòÉ
Explanation
You did not select Save a backup version and the update failed. Therefore, the
installation and maintenance utility cannot restore the product to a stable
service level.
Response
Do not attempt to run the product until you successfully restore it to a stable
state.
1. Select Cancel to remove this error message.
2. Return to the main window and then try to update the product again.
3. If the error persists, delete the product and install it again.
ΓòÉΓòÉΓòÉ 19.64. Help for EPFIE190 ΓòÉΓòÉΓòÉ
Explanation
The system cannot complete the print operation because of a workstation printer
error. This error can be caused by any of the following:
o Insufficient available disk space
o The printer is off line
o The OS/2 * Print Manager is not running
Note: The Print Manager must be active and a workstation printer must
be associated with LPT1 in order for the print operation to work.
Response
1. Select Cancel to remove this error message.
2. Ensure that the OS/2 Print Manager is set up properly and is running. If
the Print Manager is not running, start it and try the operation again.
3. Check the OS/2 Print Manager for additional information regarding this
error.
ΓòÉΓòÉΓòÉ 19.65. Help for EPFIE191 ΓòÉΓòÉΓòÉ
Explanation
The operation cannot be completed because the specified drive could not be
accessed. This error could be caused by any of the following:
o The specified drive is a diskette drive and a disk needs to be inserted.
o The drive is disconnected from the machine.
Response
1. Ensure that a disk is in the specified drive and that the drive is
connected.
2. Select the Retry push button to try the operation again.
ΓòÉΓòÉΓòÉ 19.66. Help for EPFII192 ΓòÉΓòÉΓòÉ
Explanation
A drive other than the default drive needs to be accessed. This requires a
disk change.
Response
Insert the required disk into the drive and select OK. If the required disk is
already in the drive, simply select OK.
ΓòÉΓòÉΓòÉ 19.67. Help for EPFIE193 ΓòÉΓòÉΓòÉ
Explanation
The specified file name is not a valid OS/2* file name or it does not exist on
the source drive. Wildcard characters are not allowed in installation file
names.
Response
If this error occurred during an open operation:
1. Select the Cancel push button on this error message box.
2. Ensure that the file name entered in the Filename field of the Open drive
catalog or Open host catalog window is valid.
3. Try the open operation again.
If this error occurred during another operation:
1. Reopen the current catalog by selecting Open catalog from the File menu.
2. Try the operation again.
3. If the error persists, contact your system administrator and report the
problem. There is probably an error in the catalog or package files that
the installation and maintenance utility is reading.
System administrators
This error can occur if you are using a file name that contains a drive
specification in the HOSTLOC, PACKAGEFILE, or PKGDESCRFILE keywords in the
catalog file or in the FILE-SOURCE or INCLUDE-NAME keywords in the package
file. The file names specified in these keywords should NOT contain drive
letters. Examples of valid keywords:
packagefile = 'drive: \wsp2\epfipkg.pkg;
vm: epfipkg enuepf12 *'
pkgdescfile = 'drive: \wsp2\epfidesc.dsc;
vm: epfidesc enuepf12 *'
hostloc = 'drive: \wsp2\; vm: ;'
source = 'drive: file.exe; vm: file exebin *'
ΓòÉΓòÉΓòÉ 19.68. Help for EPFIE195 ΓòÉΓòÉΓòÉ
Explanation
An error has occurred that affects the data integrity of the file being
transferred. The source files may be corrupted. The installation or update
cannot complete successfully unless this problem is fixed.
Response
1. Select the Retry push button to retry the file transfer.
2. If the error persists, then the source files are most likely in error.
Contact your product service representative to obtain a new set of source
files.
ΓòÉΓòÉΓòÉ 19.69. Help for EPFIE196 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while unpacking a compressed file. The installation or update
cannot complete successfully unless this problem is fixed.
Response
1. Select the Retry push button to retry the unpack operation.
2. If the error persists then the product is probably corrupted or in error.
Contact your product service representative to obtain a new set of
installation files or diskettes.
ΓòÉΓòÉΓòÉ 19.70. Help for EPFIE197 ΓòÉΓòÉΓòÉ
Explanation
An error occurred while unpacking a compressed file. The installation or update
cannot complete successfully unless this problem is fixed.
Response
1. Select the Retry push button to retry the unpack operation.
2. If the error persists then the product is probably corrupted or in error.
Contact your product service representative to obtain a new set of
installation files or diskettes.
ΓòÉΓòÉΓòÉ 19.71. Help for EPFIE198 ΓòÉΓòÉΓòÉ
Explanation
A file needed for the installation or update was not found within the
appropriate compressed file. This error could be caused by any of the
following:
o When the compressed file was created, the specified file was not
included.
o An error exists within the product's package file. Most likely, the FILE
entry that corresponds to the specified file contains a value for the
PACKID keyword that does not match the correct PACK file.
Response
Users:
Report the error to your system administrator.
Package file builders:
1. Examine the FILE entry that corresponds to the specified file and fix any
errors that are found.
2. If no errors are found in the package file, rebuild the compressed file.
Make sure that the specified file is included in the compressed file.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.72. Help for EPFIE199 ΓòÉΓòÉΓòÉ
Explanation
An error exists in the product's package file. The FILE entry that corresponds
to the specified file contains an invalid PACKID.
Response
Users:
Report the error to your system administrator.
Package file builders:
1. Examine the FILE entry that corresponds to the specified file and correct
any errors that are found. Make sure that a PACKFILE entry exists that
matches the PACKID specified in the FILE entry.
2. Try the operation again.
ΓòÉΓòÉΓòÉ 19.73. Help for EPFIE200 ΓòÉΓòÉΓòÉ
Explanation
The installation and maintenance utility cannot find a specified PACK file on
the source system. This could be because the file is not present on the source
system or the package file contains an error.
Response
Users
1. Select one of the following:
Cancel Cancels the file transfer
Retry Issues the transfer commands again
2. Contact your system administrator if the problem persists.
System administrators
1. Check the SOURCE keyword of the PACKFILE entry type that corresponds to
the specified file to ensure that the file name is correct.
2. If the package file is correct, ensure that the file exists on the source
system.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.74. Help for EPFIE201 ΓòÉΓòÉΓòÉ
Explanation
The catalog that was opened does not contain any new products. It contains
only program fixes for other product(s). Before these fixes can be applied,
you must install the product(s).
Response
If you want to apply these fixes, you must first install the product(s). If you
have already installed the product(s), it is possible that the application
profile file has been corrupted or deleted. If this is the case, you must
install the products again. When doing this installation, specify the same
directories where the products were originally installed.
ΓòÉΓòÉΓòÉ 19.75. Help for EPFIE203 ΓòÉΓòÉΓòÉ
Explanation
The command line option you specified is valid, but the value specified (the
part on the right-hand side of the equal sign) is not valid.
Response
Correct the command line option value and try the operation again.
ΓòÉΓòÉΓòÉ 19.76. Help for EPFIE204 ΓòÉΓòÉΓòÉ
Explanation
An unknown command line option was specified.
Response
Enter the correct command line option and try the operation again.
ΓòÉΓòÉΓòÉ 19.77. Command line parameters ΓòÉΓòÉΓòÉ
Use the EPFINSTS command followed by one or more of the following parameters at
the OS/2 ready prompt.
If the value of any of the parameters contains spaces, you must use double
quotes to enclose the value.
The parameters can be specified in any order.
Parameter Description
/A=action
Specifies the action to be performed.
If this parameter is present with a valid value, the main
installation utility window is not displayed. In this case, windows
are displayed directly on the OS/2* Workplace Shell.
If you do not use this parameter, the installation and maintenance
utility starts normally with all windows displayed. Values can be
upper or lower case. Valid values for this parameter are:
d For delete
i For install
r For restore
u For update
Use of this parameter requires that the /P parameter also be
specified.
/C=catfilename
Specifies the name and location of the catalog file.
If the catalog file is located on a host system, the host session ID
must precede the catalog file name.
If the catalog file is located on a diskette, LAN, or AS/400 Shared
folder, a drive and directory must precede the catalog file name.
The following are examples of the /C parameter for each source:
Drive
/C=Z:\EPFICAT.CAT
MVS
/C=B:EPF.V1R1M0.SEPFBENU(EPFICAT)
VM
/C="B:EPFICAT ENUEPF11 *"
VSE
/C=B:LIB.SIBLIB.MEMBERNAME.MEMBERTYPE
If this parameter is present, the specified catalog file is
automatically opened.
/G:include path
Specifies the drive and path of the general response files that are
included by the specific response file.
The installation and maintenance utility sets the EPFIGENRESPDIR
installation variable to the include path.
Example:
/G:L:\XYZ
/L=xpos,ypos
Specifies the initial x and y coordinates of the Installation and
Maintenance window on the desktop relative to the lower-left corner
of the screen.
If this parameter is specified, all previously saved default
positions are overridden.
/L1:error log
Specifies the drive, path, and file name of the destination of the
error log file.
The installation and maintenance utility sets the EPFIERRORLOG
installation variable to the error log.
If drive and path are not specified, the drive and path where
EPFINSTS.EXE is running is used. If file name is not specified,
errors are logged to EPFINSTS.OUT.
Example:
/L1:C:\ABC\ERROR.LOG
/L2:history log
Specifies the drive, path, and file name of the destination of the
history log file.
The installation and maintenance utility sets the EPFIHISTORYLOG
installation variable to the history log.
If drive and path are not specified, the drive and path where
EPFINSTS.EXE is running is used.
If this parameter is not specified, no history log is maintained.
Example:
/L2:C:\ABC\HISTORY.LOG
/L3: /L4: /L5:log files
Each of these parameters can contain a drive, path, and file name of
a log file. They are preserved in installation variables EPFIL3LOG,
EPFIL4LOG, and EPFIL5LOG for your use.
/P=prodname
Specifies the name of the product on which the action is performed.
If the product name contains spaces, it must be enclosed in double
quotes (").
Sample valid product name specifications:
/P="Product name with spaces"
/P=productname
/R:response file
Specifies the drive, path, and file name of the specific response
file.
The installation and maintenance utility sets the EPFIRESPFILE
installation variable to the response file.
Example:
/R:L:\XYZ\RESPONSE.DAT
/O=source environment
Specifies the source environment (origin) of the installation or
update. Valid values for this parameter are:
o DRIVE
o MVS
o VM
o VSE
This parameter is ignored for a delete or restore action.
/S:source location
Specifies the drive and path that contain the source files to be
installed.
The installation and maintenance utility sets the EPFISOURCEDIR
installation variable to the source location.
Specifying this parameter sets the /S parameter to DRIVE and
overrides the value of the HOSTLOC keyword in the product's catalog
file.
If this parameter is not specified the value of the HOSTLOC keyword
is not overridden.
Example:
/S:L:\XYZ
/T:install target directory
Specifies the drive and path of that the product files are installed
into.
This parameter only affects the value of the FILE directory
(directory corresponding to the FILELABEL keyword).
The installation and maintenance utility sets the EPFITARGETDIR
installation variable to the install target directory.
Example:
/T:C:\IBB
/ TU:update target CONFIG.SYS directory
Specifies the drive and path of the target CONFIG.SYS to be updated.
The installation and maintenance utility sets the EPFITARGETCNF
installation variable to the update CONFIG.SYS target directory.
If this parameter is not specified the CONFIG.SYS files are updated
as specified in the product's package file.
Example:
/TU:C:\
/X
Specifies that the action is unattended.
When you specify this parameter no progress indication is shown.
If information needed for the action to complete is not specified,
an error occurs. If you specify /L1:, all error messages are logged
to the error log file specified. If /L1: is not specified, error
messages are logged to the EPFINSTS.OUT file.
If this parameter is not specified, the user will be prompted for
any information that is needed for the action to complete. In this
attended mode of operation, progress indication is shown, and error
messages are displayed to the user in message boxes.
ΓòÉΓòÉΓòÉ 19.78. Response file parameters ΓòÉΓòÉΓòÉ
In general, the format for parameters within a response file is parameter =
value.
Only one parameter can be specified per line and parameters can occur in any
order.
The following parameters are valid in an installation response file.
Parameter Description
auxn
Specifies the new default path for the auxiliary directory where n
is any number between 1 and 18. (Thus there are 18 possible
auxiliary directories: AUX1, AUX2,...AUX18.) Use this parameter
only for an install action.
comp
Specifies a component within the product for which the operation is
to be performed. Use multiple comp parameters to specify more than
one component. Invalid components are ignored.
cfgupdate
Specifies whether the CONFIG.SYS file is automatically updated.
Valid values for this parameter are AUTO (automatically update
CONFIG.SYS) or MANUAL (do not update CONFIG.SYS). This parameter is
used only for install or update actions and is ignored if any other
action is specified.
copy
Specifies the source and target files for a copy process. The
format of this parameter is:
COPY = from_filespec to_filespec
Where from_filespec is the source file and to_filespec is the
target file. If the to_filespec already exists, it is overwritten.
If either file specification is not valid, the copy is not
performed.
deletebackup
Specifies whether to delete only the backup versions of the product
or to delete the entire product. Valid values for this parameter
are YES or NO. This parameter is used only for a delete action and
is ignored if any other action is specified.
file
Specifies the FILE directory that the product is to be installed
into. This parameter is used only for an install action and is
ignored if any other action is specified.
include
Specifies the which general response files to include with a
specific response file. The format of this parameter is:
INCLUDE = filespec
Where filespec is the general response file to be included. If the
file specification contains any global characters (* or ?), the
first file found which matches the specification is included. If
the specification is not valid, no general response file is
included.
The following search order is used to find the general response
files specified.
1. The fully qualified file specification, if specified with
filespec
2. The current directory
3. The file name together with the /G: invocation parameter
4. Each directory in the PATH environment variable
5. Each directory in the DPATH environment variable
overwrite
Specifies whether to automatically overwrite files during
installation. Valid values for this parameter are YES or NO. This
parameter is used only for an install action and is ignored if any
other action is specified.
savebackup
Specifies whether to save a backup version of the product when it
is updated. Valid values for this parameter are YES or NO. This
parameter is used only for an update action and is ignored if any
other action is specified.
userexit
Specifies the name of a user exit that you want started. The format
of this parameter is:
USEREXIT = filespec
Where filespec is the name of a user exit. If the file
specification contains any global characters (* or ?), the first
executable found which matches the specification is started. If
the specification is not valid, no user exit is started.
The following search order is used to find the specified user exit.
1. The fully qualified file specification, if specified with
filespec
2. The current directory
3. Each directory in the PATH environment variable
4. Each directory in the DPATH environment variable
work
Specifies the WORK directory that will be used during product
installation. This parameter is used only for an install action
and is ignored if any other action is specified.
ΓòÉΓòÉΓòÉ 19.79. Help for EPFIE205 ΓòÉΓòÉΓòÉ
Explanation
The installation that was requested cannot be performed because the specified
product has already been installed. A product cannot be installed more than
once on a workstation.
Response
To install a new version of the product, you must first delete the current
version. Refer to the product's documentation for further information.
If you are attempting to apply a program fix, use the Update action.
ΓòÉΓòÉΓòÉ 19.80. Help for EPFIE206 ΓòÉΓòÉΓòÉ
Explanation
An unrecognized parameter was found within the specified response file.
Response
Enter the correct response file parameters and try the operation again.
ΓòÉΓòÉΓòÉ 19.81. Help for EPFIE207 ΓòÉΓòÉΓòÉ
Explanation
The response file parameter specified is valid, but the value specified (on the
right-hand side of the equal sign) is not valid.
Response
Correct the response file parameters and try the operation again.
ΓòÉΓòÉΓòÉ 19.82. Help for EPFIE208 ΓòÉΓòÉΓòÉ
Explanation
More than 100 component parameters exist within the response file. A maximum of
100 component parameters are allowed.
Response
Remove unneeded component parameters from the response file and try the
operation again.
ΓòÉΓòÉΓòÉ 19.83. Help for EPFIE210 ΓòÉΓòÉΓòÉ
Explanation
The requested operation cannot be performed because the product name specified
is not valid. The product name specified as the value of the /p parameter must
exactly match the product name as it appears in the product list. If the
product name contains spaces then it must be enclosed within double quotes (").
Sample valid product name specifications:
/p="Product name with spaces"
/p=productname
Response
Correct the /p parameter and try the operation again.
ΓòÉΓòÉΓòÉ 19.84. Help for EPFIE211 ΓòÉΓòÉΓòÉ
Explanation
The operation requested from the command line options cannot be performed
without the /p parameter. A product name must be specified when performing an
install, update, restore, or delete.
Response
Add a /p parameter to specify a product name and try the operation again.
ΓòÉΓòÉΓòÉ 19.85. Help for EPFIE212 ΓòÉΓòÉΓòÉ
Explanation
The /x command line option specified that a completely unattended installation
be performed, but not enough information was specified. In order for the
operation to complete successfully, all the information needed to complete the
operation must be specified on the command line or in the response file.
Response
1. Try the command again omitting the /x parameter. This allows the
installation and maintenance utility to prompt for the missing
information.
2. After seeing what information is missing, specify this missing
information using command line options and response file parameters.
3. Try the command again using the /x parameter.
4. If the operation is not successful, repeat this procedure starting from
step 1.
ΓòÉΓòÉΓòÉ 19.86. Help for EPFIE213 ΓòÉΓòÉΓòÉ
Explanation
The update operation requested from the command line options cannot be
performed because the specified product is not installed. A product cannot be
updated unless it has been installed.
Response
If you want to update the product, you must first install it. Refer to the
documentation for your product for further information on installation.
ΓòÉΓòÉΓòÉ 19.87. Help for EPFIE214 ΓòÉΓòÉΓòÉ
Explanation
The delete operation requested from the command line options cannot be
performed because the specified product is not installed. A product cannot be
deleted unless it has been installed.
Response
If you have installed the product, it is possible that the application profile
file has been corrupted or deleted. If this is the case, you must install the
product again and then delete it. When doing this second installation, specify
the same directories where the product was originally installed. The
installation will go very quickly since no files will need to be transferred.
ΓòÉΓòÉΓòÉ 19.88. Help for EPFIE215 ΓòÉΓòÉΓòÉ
Explanation
The restore operation requested from the command line options cannot be
performed because the specified product has not been installed and updated. A
product cannot be restored unless it has been installed and then updated at
least once (with the Save a backup version option selected).
ΓòÉΓòÉΓòÉ 19.89. Help for EPFIQ216 ΓòÉΓòÉΓòÉ
Explanation
A selected component (or component backup) cannot be deleted because another
component is dependent upon it.
Response
Select one of the following:
Yes
Deletes the dependent component.
No
Exits the error message box and returns you to the Delete window. You
can cancel the selection of the specified component and try the deletion
again.
ΓòÉΓòÉΓòÉ 19.90. Help for EPFIE218 ΓòÉΓòÉΓòÉ
Explanation
The requested action requires the HLLAPI interface to Communications Manager,
but the HLLAPI DLL (ACS3EHAP.DLL) cannot be loaded.
Response
1. Ensure that you have Communications Manager installed, including the
HLLAPI programming interfaces.
2. If HLLAPI is installed, ensure that the LIBPATH statement in your
CONFIG.SYS file is set so that it contains the path where the HLLAPI DLL
is located. If a change is required to the CONFIG.SYS file, you must
restart your workstation in order to activate the change.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.91. Help for EPFIE219 ΓòÉΓòÉΓòÉ
Explanation
A catalog or package file has been recursively included by another catalog or
package file, causing an infinite loop.
The simplest example of this problem is a product that contains two package
files, A and B. If package file A includes package file B and package file B
includes package file A, then an infinite loop results.
Response
Remove the INCLUDE entry that is causing this problem from the catalog or
package file and try the operation again.
ΓòÉΓòÉΓòÉ 19.92. Help for EPFIE220 ΓòÉΓòÉΓòÉ
Explanation
The /o command line option must be specified if the /c command line option is
used. The /o option specifies the source of the open operation (VM, MVS, VSE,
or Drive) and is required to correctly perform the open operation.
Response
Specify the source of the operation by using the /o command line option and
then try the operation again.
ΓòÉΓòÉΓòÉ 19.93. Help for EPFIE223 ΓòÉΓòÉΓòÉ
Explanation
Most likely the selected product was installed using a previous version of the
installation and maintenance utility. The current version of the installation
and maintenance utility requires additional information to complete the
requested operation.
Response
To obtain the additional information, open the catalog that the selected
product is in. After the open is complete, select the product and try the
operation again.
ΓòÉΓòÉΓòÉ 19.94. Help for EPFIE224 ΓòÉΓòÉΓòÉ
Explanation
You can only enter a drive letter followed by a colon (for example, C:).
Response
o Correct the entry.
o Try the operation again.
ΓòÉΓòÉΓòÉ 19.95. Help for EPFIE225 ΓòÉΓòÉΓòÉ
Explanation
A temporary directory to hold deferred installation files cannot be created.
This can occur for the following reasons:
o The drive is not recognized. This can be caused if a file with a High
Performance File System (HPFS) name or extension is transferred to a
drive formatted with the FAT file system.
o Another application is using the drive.
Response
1. Try one of the following:
o Select a different drive.
o Format the drive.
o Wait until the other application is finished.
2. Try the operation again.
ΓòÉΓòÉΓòÉ 19.96. Help for EPFIE226 ΓòÉΓòÉΓòÉ
Explanation
The deferred installation command file cannot be written to. Another program
might be using this file, or there is no more disk space on the boot drive.
Response
1. Check the disk space.
2. Close any program using the file.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.97. Help for EPFIE227 ΓòÉΓòÉΓòÉ
Explanation
The deferred installation preparation failed because CONFIG.SYS is a read-only
file or there is not enough disk space on the boot drive.
Response
1. Ensure that your CONFIG.SYS is not a read-only file.
2. Remove some files from the boot drive.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.98. Help for EPFIE232 ΓòÉΓòÉΓòÉ
Explanation
The specified expression is not valid. This could be for one of the following
reasons:
o Parentheses are mismatched. Either a left parenthesis exists without a
matching right parenthesis or vice versa.
o The syntax of the expression is not correct. An operator may be missing
an operand, or an operand may exist without an operator.
o Evaluation of the expression causes a division by zero to occur.
Response
1. Correct the expression within the package file.
2. Try the operation again.
ΓòÉΓòÉΓòÉ 19.99. Help for EPFIE233 ΓòÉΓòÉΓòÉ
Explanation
One of the operators in the specified expression has operands of different
types. All operators require that the operands be of the same type. Examples
of expressions that contain operand type conflicts are:
"string" == 123
"string" / "string"
("string" == "string") && "string2"
Response
1. Correct the expression within the package file.
2. Try the operation again.
ΓòÉΓòÉΓòÉ 19.100. Help for EPFIE234 ΓòÉΓòÉΓòÉ
Explanation
The CREATEWPSOBJECT installation exit could not create the specified object.
The object may already exist on the desktop.
Response
1. Specify 'R' for the replace parameter in the package file.
2. Verify that the parameters in the setup string are valid for the object
class for which you are creating an instance.
3. Try the operation again.
ΓòÉΓòÉΓòÉ 19.101. Help for EPFIW235 ΓòÉΓòÉΓòÉ
Explanation
Without the current level of OS/2 2.0 installed, your product installation may
cause your workstation to hang.
Response
Install the current version of OS/2 (CSD XR06055 or above).
ΓòÉΓòÉΓòÉ 19.102. Help for EPFIE236 ΓòÉΓòÉΓòÉ
Explanation
The specified drive does not have enough space to save a backup.
Response
1. Make space on the drive.
2. Select Retry.
or
Select Cancel.
ΓòÉΓòÉΓòÉ 19.103. Help for EPFIW237 ΓòÉΓòÉΓòÉ
Explanation
The value specified for the indicated log parameter cannot be used. The value
is invalid if the log file cannot be created on the specified drive and path,
or if the specified log file cannot be appended to. Possible causes are:
o The specified drive does not exist
o The specified drive, directory, or file is read-only.
Response
Do one of the following:
o Select OK to continue without writing to the indicated log
o Select Cancel to cancel the action, then re-invoke using a valid value
for the indicated log.
ΓòÉΓòÉΓòÉ 19.104. Help for EPFIW238 ΓòÉΓòÉΓòÉ
Explanation
The value specified for the indicated log parameter cannot be used but the
displayed alternate value will be used if you continue. The provided value is
invalid if the log file cannot be created on the specified drive and path, or
if the specified log file cannot be appended to. Possible causes are:
o The specified drive does not exist
o The specified drive, directory, or file is read-only.
Response
Do one of the following:
o Select OK to continue processing using the displayed alternate value
o Select Cancel to cancel the action, then re-invoke using a valid value
for the indicated log.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
Trademark of